List Datasets
Route
/v2/datasets
Description
Retrieve a list of all available datasets in your organization. Datasets define collections of data for classification and protection policies.
Method
GET
Inputs
| Parameter | Type | Required | Description |
|---|---|---|---|
| None | - | - | No parameters required |
Output
| Field | Type | Description |
|---|---|---|
type | string | Always "datasets" |
size | integer | Number of datasets returned |
resources | array[Dataset] | Array of dataset objects |
errors | array[Error] | Any errors encountered |
Dataset Object Structure
| Field | Type | Description |
|---|---|---|
id | string | Unique dataset identifier |
name | string | Human-readable name |
description | string | Detailed description |
sensitivity | string | Sensitivity level (unrestricted, low, moderate, high, critical) |
domain | string | Domain category (corporate, partner, personal, public) |
created_at | string | Creation timestamp (ISO 8601) |
backfills_enabled | boolean | Whether historical data processing is enabled |
Rate Limit
- 60 requests per minute per API key
- 5 concurrent requests per endpoint
Example Response
{
"type": "datasets",
"size": 2,
"resources": [
{
"id": "dataset-123",
"name": "Customer PII",
"description": "Personal identifiable information of customers",
"sensitivity": "high",
"domain": "corporate",
"created_at": "2024-01-15T10:30:00Z",
"backfills_enabled": true
},
{
"id": "dataset-456",
"name": "Public Marketing",
"description": "Public marketing materials and content",
"sensitivity": "unrestricted",
"domain": "public",
"created_at": "2024-01-10T14:20:00Z",
"backfills_enabled": false
}
],
"errors": []
}